Skip to content

查询单笔退款

提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,建议在提交退款申请后1分钟发起查询退款状态,一般来说零钱支付的退款5分钟内到账,银行卡支付的退款1-3个工作日到账。

请求参数类型描述
out_refund_nostring商户退款单号
queryobject声明请求的查询参数
sub_mchidstring子商户号
php
$instance->v3->refund->domestic->refunds->_out_refund_no_->getAsync([
  'out_refund_no' => 'sdk12345678920210326144648',
  'query' => [
    'sub_mchid' => '1900000109',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/refund/domestic/refunds/{out_refund_no}')->getAsync([
  'out_refund_no' => 'sdk12345678920210326144648',
  'query' => [
    'sub_mchid' => '1900000109',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/refund/domestic/refunds/{out_refund_no}']->getAsync([
  'out_refund_no' => 'sdk12345678920210326144648',
  'query' => [
    'sub_mchid' => '1900000109',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->refund->domestic->refunds->_out_refund_no_->get([
  'out_refund_no' => 'sdk12345678920210326144648',
  'query' => [
    'sub_mchid' => '1900000109',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/refund/domestic/refunds/{out_refund_no}')->get([
  'out_refund_no' => 'sdk12345678920210326144648',
  'query' => [
    'sub_mchid' => '1900000109',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/refund/domestic/refunds/{out_refund_no}']->get([
  'out_refund_no' => 'sdk12345678920210326144648',
  'query' => [
    'sub_mchid' => '1900000109',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
refund_idstring微信支付退款号
out_refund_nostring商户退款单号
transaction_idstring微信支付订单号
out_trade_nostring商户订单号
channelstring退款渠道
user_received_accountstring退款入账账户
success_timestring退款成功时间
create_timestring退款创建时间
statusstring退款状态
funds_accountstring资金账户
amountobject金额信息
totalinteger订单金额
refundinteger退款金额
fromobject[]退款出资账户及金额
accountstring出资账户类型
amountinteger出资金额
payer_totalinteger用户支付金额
payer_refundinteger用户退款金额
settlement_refundinteger应结退款金额
settlement_totalinteger应结订单金额
discount_refundinteger优惠退款金额
currencystring退款币种
refund_feenumber手续费退款金额
promotion_detailobject[]优惠退款信息
promotion_idstring券ID
scopestring优惠范围
typestring优惠类型
amountinteger优惠券面额
refund_amountinteger优惠退款金额
goods_detailobject[]商品列表
merchant_goods_idstring商户侧商品编码
wechatpay_goods_idstring微信侧商品编码
goods_namestring商品名称
unit_priceinteger商品单价
refund_amountinteger商品退款金额
refund_quantityinteger商品退货数量

参阅 官方文档 官方文档 官方文档 官方文档

Published on the GitHub by TheNorthMemory